---
title: 'Introduction'
description: 'Welcome to DroidRun - Control Android devices with LLM agents'
---

# Welcome to DroidRun

DroidRun is a powerful framework that enables you to control Android devices through LLM agents. It provides a simple and intuitive way to automate Android and iOS device interactions using natural language commands.

## Features

<CardGroup cols={2}>
  <Card title="Natural Language Control" icon="wand-magic-sparkles">
    Control your Android device using natural language commands
  </Card>
  <Card title="Multiple LLM Support" icon="brain">
    Support for OpenAI, Anthropic, and Google Gemini
  </Card>
  <Card title="Simple CLI" icon="terminal">
    Easy-to-use command line interface
  </Card>
  <Card title="Python SDK" icon="code">
    Comprehensive SDK for custom automation tasks
  </Card>
</CardGroup>

## Quick Example

```bash
# Simple CLI usage
droidrun "Open the settings app"

# With specific provider
droidrun "Open calculator app" --provider Gemini --model models/gemini-2.5-pro
```

Or with Python:

```python
import asyncio
from droidrun import DroidAgent, load_llm, AdbTools

async def main():
    # initialize agent tools (ios/adb/web)
    tools = AdbTools(serial=device)

    # initialize llm adapter
    llm = load_llm(provider_name="Gemini", model="models/gemini-2.5-pro")
    
    # Create the DroidAgent
    agent = DroidAgent(
      goal=command,
      llm=llm,
      tools=tools,
    )

    result = await agent.run()
    
    print(f"Success: {result['success']} in {result['steps']} steps -> {result['reason']}")

if __name__ == "__main__":
    asyncio.run(main())
```

## Prerequisites

- API key for at least one LLM provider (OpenAI, Anthropic, or Google Gemini)

**for Android**
- Android device connected via USB or ADB over TCP/IP
- ADB (Android Debug Bridge) installed
- Droidrun Portal installed on device

**for iOS**
- Run the [Droidrun Portal iOS service]()

## Getting Started

<CardGroup cols={3}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Get up and running with DroidRun in minutes
  </Card>
  <Card title="Installation" icon="download" href="/installation">
    Step-by-step installation guide
  </Card>
</CardGroup>

## Core Concepts

<CardGroup cols={2}>
  <Card title="Agent" icon="robot" href="/concepts/agent">
    Learn about the ReAct agent system
  </Card>
  <Card title="Android Control" icon="mobile" href="/concepts/android-control">
    Explore Android device interactions
  </Card>
</CardGroup> 